home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtOwnSelection.z / XtOwnSelection
Encoding:
Text File  |  2002-10-03  |  7.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttOOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666)))) XXXXttttOOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtOwnSelection, XtOwnSelectionIncremental, XtDisownSelection
  10.           - set selection owner
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           Boolean XtOwnSelection(_w, _s_e_l_e_c_t_i_o_n, _t_i_m_e, _c_o_n_v_e_r_t__p_r_o_c,
  14.           _l_o_s_e__s_e_l_e_c_t_i_o_n, _d_o_n_e__p_r_o_c)
  15.                 Widget _w;
  16.                 Atom _s_e_l_e_c_t_i_o_n;
  17.                 Time _t_i_m_e;
  18.                 XtConvertSelectionProc _c_o_n_v_e_r_t__p_r_o_c;
  19.                 XtLoseSelectionProc _l_o_s_e__s_e_l_e_c_t_i_o_n;
  20.                 XtSelectionDoneProc _d_o_n_e__p_r_o_c;
  21.  
  22.           Boolean XtOwnSelectionIncremental(_w, _s_e_l_e_c_t_i_o_n, _t_i_m_e,
  23.           _c_o_n_v_e_r_t__c_a_l_l_b_a_c_k, _l_o_s_e__c_a_l_l_b_a_c_k, _d_o_n_e__c_a_l_l_b_a_c_k,
  24.           _c_a_n_c_e_l__c_a_l_l_b_a_c_k, _c_l_i_e_n_t__d_a_t_a)
  25.                 Widget _w;
  26.                 Atom _s_e_l_e_c_t_i_o_n;
  27.                 Time _t_i_m_e;
  28.                 XtConvertSelectionIncrProc _c_o_n_v_e_r_t__c_a_l_l_b_a_c_k;
  29.                 XtLoseSelectionIncrProc _l_o_s_e__c_a_l_l_b_a_c_k;
  30.                 XtSelectionDoneIncrProc _d_o_n_e__c_a_l_l_b_a_c_k;
  31.                 XtCancelConvertSelectionProc _c_a_n_c_e_l__c_a_l_l_b_a_c_k;
  32.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  33.  
  34.           void XtDisownSelection(_w, _s_e_l_e_c_t_i_o_n, _t_i_m_e)
  35.                 Widget _w;
  36.                 Atom _s_e_l_e_c_t_i_o_n;
  37.                 Time _t_i_m_e;
  38.  
  39.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  40.           _c_o_n_v_e_r_t__p_r_o_c
  41.                     Specifies the procedure that is to be called
  42.                     whenever someone requests the current value of the
  43.                     selection.
  44.  
  45.           _d_o_n_e__p_r_o_c Specifies the procedure that is called after the
  46.                     requestor has received the selection or NULL if
  47.                     the owner is not interested in being called back.
  48.  
  49.           _l_o_s_e__s_e_l_e_c_t_i_o_n
  50.                     Specifies the procedure that is to be called
  51.                     whenever the widget has lost selection ownership
  52.                     or NULL if the owner is not interested in being
  53.                     called back.
  54.  
  55.           _s_e_l_e_c_t_i_o_n Specifies an atom that describes the type of the
  56.                     selection (for example, _X_A__P_R_I_M_A_R_Y, _X_A__S_E_C_O_N_D_A_R_Y,
  57.                     or _X_A__C_L_I_P_B_O_A_R_D).
  58.  
  59.           _t_i_m_e      Specifies the timestamp that indicates when the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttOOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666)))) XXXXttttOOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.                     selection ownership should commence or is to be
  75.                     relinquished.
  76.  
  77.           _w         Specifies the widget that wishes to become the
  78.                     owner or to relinquish ownership.
  79.  
  80.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  81.           The _X_t_O_w_n_S_e_l_e_c_t_i_o_n function informs the Intrinsics selection
  82.           mechanism that a widget believes it owns a selection.  It
  83.           returns _T_r_u_e if the widget has successfully become the owner
  84.           and _F_a_l_s_e otherwise.  The widget may fail to become the
  85.           owner if some other widget has asserted ownership at a time
  86.           later than this widget.  Note that widgets can lose
  87.           selection ownership either because someone else asserted
  88.           later ownership of the selection or because the widget
  89.           voluntarily gave up ownership of the selection.  Also note
  90.           that the lose_selection procedure is not called if the
  91.           widget fails to obtain selection ownership in the first
  92.           place.
  93.  
  94.           The _X_t_O_w_n_S_e_l_e_c_t_i_o_n_I_n_r_c_r_e_m_e_n_t_a_l procedure informs the
  95.           Intrinsics incremental selection mechanism that the
  96.           specified widget wishes to own the selection. It returns
  97.           _T_r_u_e if the specified widget successfully becomes the
  98.           selection owner or _F_a_l_s_e otherwise. For more information
  99.           about _s_e_l_e_c_t_i_o_n, _t_a_r_g_e_t, and _t_i_m_e, see Section 2.6 of the
  100.           _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l.
  101.  
  102.           A widget that becomes the selection owner using
  103.           _X_t_O_w_n_S_e_l_e_c_t_i_o_n_I_n_c_r_e_m_e_n_t_a_l may use _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n to
  104.           relinquish selection ownership.
  105.  
  106.           The _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n function informs the Intrinsics
  107.           selection mechanism that the specified widget is to lose
  108.           ownership of the selection.  If the widget does not
  109.           currently own the selection either because it lost the
  110.           selection or because it never had the selection to begin
  111.           with, _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n does nothing.
  112.  
  113.           After a widget has called _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n, its convert
  114.           procedure is not called even if a request arrives later with
  115.           a timestamp during the period that this widget owned the
  116.           selection.  However, its done procedure will be called if a
  117.           conversion that started before the call to _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n
  118.           finishes after the call to _X_t_D_i_s_o_w_n_S_e_l_e_c_t_i_o_n.
  119.  
  120.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  121.           XtAppGetSelectionTimeout(3Xt), XtGetSelectionValue(3Xt)
  122.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  123.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.